Release 10.1A: OpenEdge Development:
Progress Dynamics Managers API Reference

launchContainer

This procedure launches a Progress Dynamics container object. It determines if the object is already running and whether the existing instance should be replaced or a new instance run. The procedure then updates the temp-table of running persistent procedures, ttPersistentProc, with the appropriate details.

Location: af\app\afsesmngrp.i

Parameters:

INPUT pcObjectFileName AS CHARACTER

The object filename. If it is not known, the physical name or the physical and logical names together can be used.

INPUT pcPhysicalName AS CHARACTER

The physical object name, with path and extension, if known.

INPUT pcLogicalName AS CHARACTER

The logical object name, if applicable and known.

INPUT plOnceOnly AS LOGICAL

If YES, then the procedure checks for an already running instance and uses it, if possible.

INPUT pcInstanceAttributes AS CHARACTER

The instance attributes to pass to the container.

INPUT pcChildDataKey AS CHARACTER

The child data key, if applicable.

INPUT pcRunAttribute AS CHARACTER

The run attribute, if required to post into the container run.

INPUT pcContainerMode AS CHARACTER

The container mode, for example, modify, view, add, or copy.

INPUT phParentWindow AS HANDLE

The parent (caller) window handle, if known. (Container window handle.)

INPUT phParentProcedure AS HANDLE

The parent (caller) procedure handle, if known. (Container procedure handle.)

INPUT phObjectProcedure AS HANDLE

The parent (caller) object handle, if known. This is the handle at the end of the toolbar link, for example, a browser.

OUTPUT phProcedureHandle AS HANDLE

The procedure handle of object to run or the running object.

OUTPUT pcProcedureType AS CHARACTER

The procedure type, for example, ADM1, ADM2, ICF, or "".

Notes: None

Examples: See the main block in af\app\xmlcfgp.p.